home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / PMCPL574.ARJ / PMCCAT.EXE / PMCATPL.DOC < prev    next >
Text File  |  1992-04-10  |  48KB  |  1,267 lines

  1.  
  2.  
  3.  
  4.                                 PM-Cat Plus
  5.  
  6.  
  7.  
  8.                       A Disk File Cataloging Program
  9.  
  10.                                     by
  11.  
  12.                            MegaSoft SoftWare(tm)
  13.  
  14.                                      &
  15.  
  16.                              William C. Scott
  17.  
  18.                         Portions by Patrick Michaud
  19.                             
  20.                               29 January 1992
  21.  
  22.  
  23.  
  24.  
  25.                                             _______
  26.                                        ____|__     |               (tm)
  27.                                     --|       |    |-------------------
  28.                                       |   ____|__  |  Association of
  29.                                       |  |       |_|  Shareware
  30.                                       |__|   o   |    Professionals
  31.                                     -----|   |   |---------------------
  32.                                          |___|___|    MEMBER
  33.  
  34.                       Copyright 1992 by William C. Scott
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                                                   Page 2
  72.  
  73.                   About Our Marketing Process ... (Shareware)
  74.  
  75.           The term "shareware" has come to refer to a class of computer
  76.           software that is marketed, basically, on an honor system.
  77.  
  78.           Hopefully you noticed the logo of ASP, the Association of
  79.           Shareware Professionals, on the cover sheet of this
  80.           documentation file.  <ASP> is an organization that was formed
  81.           and is supported by software authors and businesses with an
  82.           interest in seeing shareware remain a viable means of
  83.           marketing high quality software at reasonable prices.
  84.  
  85.           An author's membership in ASP guarantees the end user at least
  86.           some protection from the vagaries of earlier and present
  87.           'public domain' software.  By becoming a member of ASP the
  88.           author has promised his/her intention to support the product
  89.           after licensing has taken place and already demonstrated to ASP
  90.           the product does in fact do what it is advertised to do and is
  91.           a fully functional piece of software (not crippled or
  92.           restricted).
  93.  
  94.           (See the file OMBUDSMAN.ASP for further info)
  95.  
  96.           The end user benefits by being able to actually try the
  97.           software before paying for it.  This ensures compatibility
  98.           both with the system it is intended for use upon and user.
  99.  
  100.           Both the author and the consumer benefit from the fact that
  101.           neither has had to bear the burden of the enormous cost of
  102.           adequate advertising.  The consumer benefits directly from the
  103.           lower cost of the software, the author somewhat more
  104.           indirectly in that he most likely would never have been able
  105.           to make the product widely available because of a lack of
  106.           capital.  In many cases you will find the support offered by
  107.           ASP authors more comprehensive than would ever be possible
  108.           from a large company.
  109.  
  110.           Finally, these ASP authors' products, like PmCat+, are not
  111.           public domain nor intended to be free.  They are offered in
  112.           good faith that they are as good as their commercial
  113.           counterparts and the authors do expect to be paid for their
  114.           efforts.
  115.  
  116.           Frankly, it is a difficult thing to offer one's work to others
  117.           with the understanding you will be compensated *only* when the
  118.           customer is convinced your product is worth purchasing.
  119.  
  120.           Please realize that PmCat+ didn't just "happen".  We have
  121.           spent a great deal of money for compilers, language tools and
  122.           hardware that is specifically dedicated to the development of
  123.           PmCat+.  This does not to even begin considering the many
  124.           hours of sitting at the keyboard, tearing out hair trying to
  125.           figure out why the obviously simple, isn't!  We must, at the
  126.           very least, recover our financial investment so that we can
  127.           continue to develop programs of this quality.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                                                   Page 3
  138.  
  139.           Strictly speaking, if you do like and use PmCat+, we expect
  140.           you to license the program after a reasonable trial period
  141.           (about 30 - 45 days).  We also realize there are those to whom
  142.           the $20 license fee would be a burden.  For those persons,
  143.           please send what you can afford and you will be registered!
  144.               Obviously, whether or not you can afford to license PmCat+
  145.           is not a consideration we would be so bold as to decide.
  146.           We will trust that everyone is being honest with themselves
  147.           and us about that matter and will, to the best of our ability,
  148.           answer any questions by anyone who wishes to inquire.
  149.  
  150.           For $20.00 you will receive:
  151.             1.  A copy of the very latest version of PmCat PLUS on 360K
  152.                  DS/DD 5.25" floppy disk.
  153.             2.  A copy of PmDelDup, a utility for deleting duplicate or
  154.                  multiple entries of the same filename in a PmCat
  155.                  catalog and optionally removing them from disk.
  156.             3.  A copy of PmConvert which will convert older PmCat files
  157.                  to the new format used in release 5.2.
  158.             4.  A copy of PM-Label for making diskette labels and
  159.                  inserts.
  160.             5.  Access to the registered user conference on the Melange
  161.                  BBS with access to the latest (registered) version of
  162.                  PmCat PLUS
  163.             6.  Placement on our mailing list to be notified of future
  164.                  updates.
  165.  
  166.           PLEASE NOTE:
  167.  
  168.           We can provide PmCat+ on 3.5" inch double density or high
  169.           density disks as well.  There is an additional $2 charge for
  170.           the 720K and $4.00 for the 1.44M because of the higher cost of
  171.           the 3.5" media.
  172.  
  173.           When you wish to register PmCat+, please send check or Money
  174.           Order to the address below:
  175.  
  176.  
  177.                              MegaSoft SoftWare(tm)
  178.                                   522 NW 14th 
  179.                               Pendleton, OR 97801
  180.                               Msg: (503) 276-6176
  181.  
  182.           See the file PM-ORDER.FRM for an invoice type order form.
  183.  
  184.           Support can be obtained by contacting us in the following ways:
  185.  
  186.                 A Message on The Melange BBS :  (405) 927-2541
  187.                             (USR HST14.4 24hrs)
  188.  
  189.                 Writing us at : MegaSoft SoftWare(tm)
  190.                                 522 NW 14th
  191.                                 Pendleton, OR. 97801  
  192.                             
  193.                 Leaving a message for : David Chamberlain at
  194.                                         (503) 276-6176
  195.  
  196.                                         or
  197.                                         (503) 276-4282
  198.  
  199.  
  200.                 This would be the best way as I can call right back!
  201.  
  202.                    
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                                                  Page 4
  209.  
  210.  
  211.  
  212.  
  213.  
  214.     COPYRIGHT NOTICE
  215.  
  216.           PmCat+, copyright 1987-92 by William C. Scott.  PmCat+ is NOT
  217.           public domain software.  You may use, copy and distribute it
  218.           freely, but you MAY NOT RESELL PmCat+.  A modest fee for
  219.           copying may be charged, not to exceed $3.00 exclusive of the
  220.           cost of disk, mailer and postage.  (See "About Our Marketing
  221.           Process" for more details)
  222.  
  223.  
  224.  
  225.  
  226.  
  227.     DISCLAIMER:
  228.  
  229.           By using this product, the user agrees that neither William C.
  230.           Scott nor MegaSoft SoftWare(tm) shall be held severly or
  231.           jointly liable for any damages, direct or consequential, that
  232.           might arise from the use, inability to use or misuse of PmCat+.
  233.  
  234.  
  235.     Warranty:
  236.  
  237.          The only warranty for PM-Cat Plus is that the distribuation
  238.          disk is free from defects in materials and workmanship. Should
  239.          the disk you receive be defective we will replace it at no cost
  240.          to you. Simply return the defective disk along with your address
  241.          to:
  242.                MegaSoft SoftWare(tm)
  243.                    522 NW 14th
  244.                Pendleton, OR.  97801
  245.  
  246.          Note: This warranty only applies to the disk we mail, we cannot
  247.                replace disk you receive from any of the authorized
  248.                distributors. Contact them for a replacement.   
  249.  
  250.  
  251.  
  252.            
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.                                                                 Page 5
  275.  
  276.  
  277.                            TABLE OF CONTENTS
  278.  
  279.         About Our Marketing - Shareware and ASP   ...............    2
  280.  
  281.         I.  Introduction   ......................................    6
  282.  
  283.        II.  Getting Started
  284.           A.  System requirements   .............................    7
  285.           B.  Features of PmCat+
  286.             1.  List of features   ..............................    7
  287.             2.  Explanation of features   .......................    8
  288.           C.  Installation   ....................................    9
  289.           D.  THINK about these things ..........................   10
  290.  
  291.       III.  Cataloging functions
  292.           A.  Create a new catalog   ............................   12
  293.           B.  Add to existing catalog   .........................   12
  294.           C.  Update an existing catalog   ......................   12
  295.           D.  Save present catalog   ............................   12
  296.  
  297.        IV.  Browse functions
  298.           A.  File information  (InfoWindow)   ..................   13
  299.           B.  Read contents of cataloged files    ...............   13
  300.           C.  Volumes listing   .................................   13
  301.           D.  Directories   .....................................   13
  302.           E.  Search   ..........................................   14
  303.           F.  Sort   ............................................   14
  304.           G.  Change catalogs   .................................   14
  305.           H.  Masks   ...........................................   14
  306.  
  307.         V.  Printing functions
  308.           A.  Formatting output   ...............................   14
  309.           B.  Printing   ........................................   16
  310.           C.  Printer set up string   ...........................   16
  311.           D.  Saving to ASCII disk file   .......................   16
  312.  
  313.        VI.  Misc functions
  314.           A.  Delete volume   ...................................   16
  315.           B.  Erase (delete) file   .............................   16
  316.           C.  Commenting   ......................................   17
  317.           D.  Shell   ...........................................   17
  318.           E.  Change volume label    ............................   17
  319.           F.  Using the .DEF file    ............................   17
  320.           G.  Using disk numbering   ............................   17
  321.           H.  Using categories   ................................   18
  322.           I.  Using Wildcards in PmCat+   .......................   19
  323.           J.  Soundex searches   ................................   19
  324.  
  325.       VII.  BBS Access  .........................................   20
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.                                                                 Page 6
  341.  
  342.     INTRODUCTION
  343.  
  344.                 PmCat+ is a floppy and hard disk file cataloging and
  345.             browsing program intended for use on PC/XT/AT and compatible
  346.             systems.
  347.  
  348.                 PmCat+ is a direct descendent of PmCat which was a disk
  349.             file cataloging program intended for use only with floppy
  350.             disk files.  So many users just naturally began using it to
  351.             catalog their hard drive files that many requests were made
  352.             for features that were obviously hard drive oriented. So, we
  353.             decided PmCat+ should accomodate hard drives gracefully.
  354.  
  355.                 The original PmCat was written by Patrick Michaud for Mr.
  356.             Scott's personal use.  Like so many others, He couldn't find a
  357.             cataloger that addressed his personal habits adequately
  358.             (simple, fast and useful were some of my prime requisites).
  359.  
  360.                 When Patrick first wrote PmCat, it was so good that he
  361.             and Mr. Scott decided to pat it on the rear and send it out
  362.             into the 'real world' as a shareware product ... "as an
  363.             experiment" just to see what happened.
  364.  
  365.                 Well, about three months later a phone call came to Mr.
  366.             Scott from Alfred Glossbrenner who was writing a book about PC
  367.             shareware products and wanted to include PmCat in his book ..
  368.             which did occur when it was published.  Mr. Scott's thoughts
  369.             at that point was ... "here's a professional in the PC world
  370.             who thinks highly enough of PmCat to choose it over all
  371.             those others...gee whiz!"  Both Patrick and Mr. Scott were
  372.             deeply flattered.
  373.  
  374.                 They soon realized their experiment had told then they had
  375.             something in PmCat.  So they set about making the necessary
  376.             improvements to make it palatable and useful to as many people
  377.             as possible.
  378.  
  379.                 As it turned out, Patrick's studies kept him from doing
  380.             much more with PmCat except correcting and cleaning up Mr.
  381.             Scott's early code as he learned to program in Turbo Pascal
  382.             in order to support PmCat.
  383.  
  384.                 Since late 1987, most of the changes made to PmCat have
  385.             been a result of Mr. Scott's meanderings through Turbo Pascal
  386.             and the PmCat code in response to users requests for changes
  387.             /fixes and improvements.
  388.  
  389.                 Now PM-Cat Plus has changed hands and is being handled
  390.             by MegaSoft SoftWare(tm) in Pendleton, Oregon. This change
  391.             was based on the need for features and support that Mr.
  392.             Scott could no longer give to the product.
  393.  
  394.                 MegaSoft SoftWare(tm) is dedicated to providing high
  395.             quailty software at a resonable cost. We will support PMCat+
  396.             to the best of our abilities and provide the end users with
  397.             those features they request ( If possible ). We are looking
  398.             forward to the feedback and support of our users and thank
  399.             you for making PMCat Plus what it is today!
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                                                 Page 7
  407.  
  408.  
  409.         Minimum System Requirements:
  410.  
  411.             IBM PC/XT/AT or compatible, 384K RAM, one floppy disk
  412.             drive.  Hard drives and subdirectories are supported.
  413.  
  414.         Suggested extra system features:
  415.  
  416.             More Memory! - PmCat+ *will* run in only 384K but 512K or
  417.                            640K is strongly recommended.
  418.  
  419.             Color monitor - either CGA, EGA or VGA makes fuller use of
  420.                             the different menu options easier.
  421.  
  422.             Mouse - these rodents are down in price to about $30 on
  423.                     the bottom line of pricing and make a lazy man's
  424.                     use of a computer much more palatable.
  425.  
  426.             Disk caching - these programs are fairly common and many are
  427.                            either public domain or shareware. This can
  428.                            speed up PmCat+ because of its use of
  429.                            overlays.
  430.  
  431.  
  432.         FEATURES
  433.              * Use categories to group your files
  434.              * Use numbering of disks through volume labels or a separate
  435.                 disk number ... or both!
  436.              * Catalog contents of archived files
  437.              * View files, archived or not while in PmCat+!
  438.              * Context sensitive help
  439.              * Mouse support
  440.              * Include and/or exclude files (read/view/print)
  441.              * Delete individual files from catalog and Now Disk!
  442.              * Delete volumes from catalog 
  443.              * Find Free Space on cataloged diskettes
  444.              * Assign a DRIVE:\PATHNAME to be a VOLUME
  445.              * Read subdirectories and labels, too
  446.              * Comment each file with up to 80 characters
  447.              * "Rubber-stamp" for comments for duplicate files
  448.              * Sort catalog by filename, ext, size, path or date
  449.              * Supports WILDCARD ("*" and "?") searches of files
  450.                and comments
  451.              * User configurable printer formatting
  452.              * Automatic update of catalog when disks are reread
  453.              * User customizing of color, catalog name, ASCII filename
  454.              * Relabel diskette if desired
  455.              * Create ASCII disk file with user-assigned name
  456.              * Multiple catalogs with your specified names
  457.              * Erase an entire disk
  458.              * Coming Soon...... The support of Expanded/Extended or
  459.                virtual memory.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                                                 Page 8
  473.  
  474.  
  475.  
  476.         Explanation of features:
  477.  
  478.                 The detailed explanation of each menu function is listed
  479.                 in the later part of the manual.  This portion explains
  480.                 the general use of the keyboard and/or mouse to access
  481.                 those options. NOTE: Some features are listed in the
  482.                 file CHANGES.DOC included with this disk. They will be
  483.                 incorparated into these documents when we re-write them!
  484.  
  485.                 The HELP function is toggled ON/OFF by pressing the 'H'
  486.                 key on the keyboard or the right AND left buttons of the
  487.                 mouse at the same time or <F1>. This function does not
  488.                 toggle in the shareware distribution copy.
  489.  
  490.                 Each menu can be accessed through three functions, the
  491.                 HOT KEY, the MENU BAR or the mouse.
  492.  
  493.                 On each menu item, one letter is capitalized. Pressing
  494.                 that letter or character on the keyboard will select
  495.                 that menu item and cause it to be executed.
  496.  
  497.                 On each menu, one item is indicated at a time by the bar
  498.                 selector or MENU BAR.  The MENU BAR is moved using the
  499.                 RIGHT and LEFT keyboard arrow keys. When the bar is on a
  500.                 item, pressing <ENTER> on the keyboard will select that
  501.                 item and cause it to be executed.
  502.  
  503.                 Where appropriate the RT/LT, UP/DN arrows, PgUp/PgDn and
  504.                 Home and End keys are active for the screen instead of
  505.                 the menu area, as well as functions available to do the
  506.                 same things on the menu with the mouse.
  507.  
  508.                 The cursor within the menu area (which you will see if a
  509.                 mouse is present) is the mouse cursor.  Use your mouse
  510.                 to select an item by placing the cursor on the item name
  511.                 or within 1 space on either side and pressing the left
  512.                 mouse button.  If HELP is turned on, another click of
  513.                 the left button is necessary to execute the function.
  514.                 This was done to allow you to see what the operation
  515.                 does before you execute it.  When HELP is turned off,
  516.                 the second click is not necessary.
  517.  
  518.                 Pressing the RIGHT mouse button is the same as pressing
  519.                 the <ESC> key on the keyboard.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.                                                                 Page 9
  539.  
  540.  
  541.  
  542.         The following items are essential only to the browsing and
  543.         archive extraction functions of PmCat+.
  544.  
  545.             The defaults installed in PmCat+ will look for the other
  546.             files it may require, in the current directory. (The
  547.             directory you are in when you run PmCat+).  The defaults
  548.             referred to involve the following programs and locations.
  549.  
  550.                 1. Text viewer/editor - PMLIST.COM 
  551.  
  552.                 2. ARC extractor - program for extracting the contents
  553.                                    of .ARC files. ARCE.COM is default.
  554.                 3. ZIP extractor - program for extracting the contents
  555.                                    of .ZIP files. PKZIP.EXE is default.
  556.                 4. ZOO extractor - program for extracting the contents
  557.                                    of .ZOO files. ZOO.EXE is default
  558.                 5. PAK extractor - program for extracting the contents
  559.                                    of .PAK files. PAK.EXE is default
  560.                 6. LZH extractor - program for extracting the contents
  561.                                    of .LZH files. LHARC.EXE is default.
  562.                 7. Scratch path -  a drive/directory path where the
  563.                                    files extracted from an archive will
  564.      (Choose carefully! .. the     be written while you view them. You
  565.       extracted file will be       cannot edit files from within an
  566.       deleted later..suggest a     archive and update the archive with
  567.       'SCRATCH' directory)         the changed file from PmCat+.
  568.                 8. Target drive - This is the drive on which PmCat+ will
  569.                                    try to find the file chosen, using
  570.                                    the pathname information stored in
  571.                                    the PmCat+ catalog. The default is
  572.                                    drive 'A'.
  573.  
  574.  
  575.  
  576.             NOTE: NO decompressing code is in the PmCat+ program.  It is
  577.                   assumed if you have files stored with a compression
  578.                   program, that program can be executed from the DOS
  579.                   command line and thereby used to extract files.
  580.                   PmCat+ just acts as a messenger between you and the
  581.                   archiving program by sending the filename to extract
  582.                   to the program you have said will extract it.
  583.  
  584.                 If you don't know how to configure your system using
  585.             PATH and don't want to deal with it (for whatever reason),
  586.             just place copies of the appropriate programs from the
  587.             above list in the same directory as your PmCat+ files and
  588.             catalog.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.                                                                 Page 10
  605.  
  606.  
  607.         Things to consider BEFORE you start building your catalog:
  608.  
  609.                 The new features added to PmCat have made a great deal
  610.                 of flexibility in structuring your catalog possible.
  611.  
  612.                 These very same features will likely confuse you if you
  613.                 decide to use them without proper consideration.  They
  614.                 CAN be ignored and everything done as always with PmCat,
  615.                 but they are there if you want or need them.
  616.  
  617.                 The features most likely to offer confusion are the DISK
  618.                 number and CATEGORY function.
  619.  
  620.                 As of version 5.3, these are NOT written to the disk in
  621.                 any manner.  They are a form of notation to aid you in
  622.                 keeping track of things with your disk collection.
  623.  
  624.         CATEGORIES - these are assigned to the volume when you catalog
  625.                 it. All files on the volume will have the same category
  626.                 in your PmCat data file.  You may Edit the categories of
  627.                 Files or Volumes once cataloged by using the Edit
  628.                 function in PmCat.  Presently, if you update the volume,
  629.                 you will lose those Edited categories and the category
  630.                 will once again be whatever you assign to the volume.
  631.                 This will be fixed in a future release..but be aware it
  632.                 is a limitation of sorts just now.
  633.  
  634.                 Assigning a category - when you Update a volume, there
  635.                 is a menu choice of CATEGORY. Select this and pick one
  636.                 of the existing categories or use the Update key to
  637.                 create a new category.  DON'T FORGET to save the new
  638.                 definitions to your .DEF file if you use CATEGORIES
  639.                 other than the defaults!
  640.  
  641.         DISK NUMBERING - in the early stages of testing, this seemed to
  642.                 create the greatest confusion.  Actually, it is a rather
  643.                 easy and powerful feature once you understand what it
  644.                 does.
  645.  
  646.                 There are three modes for Disk Numbering, OFF, MANual,
  647.                 and AUTOmatic and these are reflected on the Update
  648.                 Screen window. They are changed by selecting Numbering
  649.                 from the menu and using the arrow keys to select the one
  650.                 you want.
  651.  
  652.                 If you select OFF, a number of '0' will be assigned as a
  653.                 placeholder in the data file and otherwise ignored.
  654.  
  655.                 If you select MANual, the number that is shown above the
  656.                 window as Disk # will be assigned to the disk when it is
  657.                 cataloged. You may assign a new or different number just
  658.                 by typing it in.
  659.  
  660.                 If you select AUTOmatic the number you set is
  661.                 automatically incremented each time a disk is cataloged.
  662.                 You may set the starting number in the same way as for
  663.                 MANual ... just type it in.
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.                                                                 Page 11
  671.  
  672.         There is also an option called Duplicate Disk Numbers Allowed
  673.                 which is a YES/NO choice.  It WILL NOT PREVENT
  674.                 duplicates, it merely checks for them as an aid to you.
  675.                 If this is set to YES, the option is essentially
  676.                 inactive... since YES indicates you want to allow
  677.                 duplicates.
  678.  
  679.                 OK, when YES and when NO?  Let's take, for example, a
  680.                 situation where you want to store your disks in strict
  681.                 numerical order (as many do).  Each disk has a small
  682.                 sticker or other marking indicating its numeric order
  683.                 in your catalog.  In such a case, every number is likely
  684.                 to be unique and you would NOT want to allow duplicate
  685.                 Disk Numbers.
  686.  
  687.                 Alternatively, perhaps you have your disks stored or
  688.                 referenced alphabetically by categories, such as GAMES,
  689.                 BASIC, etc.  In this case you can catalog your disks
  690.                 using CATEGORIES and AUTOmatic numbering with duplicate
  691.                 disk numbers allowed.  You might catalog 5 games disks,
  692.                 as GAMES 1 thru GAMES 5 and your BASIC disks in the same
  693.                 manner.  As the categories grow, it is a simple matter
  694.                 to add GAMES 6, GAMES 7 and so on to your library. PmCat
  695.                 will allow you to view only the GAMES category disks if
  696.                 you like by selecting the <L>imit option in the <V>iew
  697.                 window.  Just place the cursor on a file with the category
  698.                 you want to limit your viewing to, and press <L>.  The
  699.                 catalog will be searched an only the GAMES (?) will be
  700.                 displayed.  (If you print at this point, only the selected
  701.                 category will be printed, as well)
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.                                                                 Page 12
  737.  
  738.     CATALOGING FUNCTIONS
  739.  
  740.         CREATE A NEW CATALOG:  <R>ead, <W>rite  on Main Menu
  741.  
  742.             Any time PmCat+ <R>eads a catalog from disk, you are shown
  743.              the current catalog name and prompted for a catalog name. If
  744.              you wish to use the catalog name shown, just press <ENTER>.
  745.              If using a mouse, place the mouse cursor on the ENTER menu
  746.              item and press the right button.
  747.  
  748.             To specify a name of your choosing just start typing it in
  749.              and press <ENTER> or press the left mouse button when
  750.              complete. A filename with wildcards is acceptable and will
  751.              place you in the 'pick list' with the appropriate files to
  752.              choose from.
  753.  
  754.             To select a catalog from the files on disk, select or type
  755.              the asterisk ('*') and press <ENTER>.  This will present
  756.              you with a 'pick list' from which to choose.
  757.  
  758.             This sequence of events first occurs when you run PmCat+. It
  759.              also happens each time you <R>ead from or <W>rite to the
  760.              disk.
  761.  
  762.  
  763.         ADD FILES/UPDATE CATALOG:    <U>pdate menu option  on Main Menu
  764.  
  765.             <U>pdate appears only on the first menu (Main Menu) you
  766.              encounter in PmCat+.  Choosing this option takes you to a
  767.              window where you may
  768.  
  769.                 1) Read files from a drive which you specify by pressing
  770.                    the appropriate letter on the keyboard or choosing it
  771.                    from the menu ... or
  772.  
  773.                 2) Change the volume label of a disk drive by using the
  774.                    '#' symbol on the menu or from the keyboard.
  775.  
  776.         SAVE CURRENT CATALOG TO DISK:  <W>rite  on Main Menu
  777.  
  778.             <W>rite will save the current catalog to disk from the
  779.              Main Menu.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.                                                                 Page 13
  803.  
  804.  
  805.  
  806.  
  807.  
  808.     BROWSE FUNCTIONS:  <I>nfo, <V>olumes, <D>ir, <SPACE>  on Command Menu
  809.  
  810.     These are the functions you will use to find files and view their
  811.     statistics, comments and contents of the actual file if desired.
  812.  
  813.         <V> menu selection from Command Menu will cause a list of volumes
  814.          contained within the current catalog to be displayed.  The
  815.          volumes may be sorted just as though they were filenames (which
  816.          really is what a DOS volume label is ... with the appropriate
  817.          attribute set).
  818.  
  819.         <D> on Command Menu will show the list of files contained within that
  820.          directory-type object.  If it is a directory then the files are
  821.          shown. If it is a compressed file then the contents of the
  822.          archive are shown if you cataloged the disk with archive reading
  823.          turned on.
  824.  
  825.         <SPACE> - pressing the spacebar will allow you to view the
  826.          contents of the file that is currently being pointed to by the
  827.          selector bar in the window.  Check to make sure the file is
  828.          located on the drive indicated on the line just above the menu.
  829.          If it needs to be changed, just press the appropriate key to
  830.          select the right drive and then press <ENTER>.  What happens at
  831.          this point is partly dependent on which program you have chosen
  832.          to run (the text viewer/editor you specified or accepted in the
  833.          Set Defaults area).
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                                                                 Page 14
  841.  
  842.  
  843.         SEARCH:  <F>ind, <N>ext   on Command Menu
  844.  
  845.         These functions are used to find files by filename, an entry in
  846.         the Comments field and they are also used to find free space on
  847.         a volume when the list of volumes is displayed. SEE NOTE ON PAGE
  848.         16 ABOUT SOUNDEX SEARCHES.
  849.  
  850.             <F>ind will first prompt you to select whether you wish to
  851.              search for a file based on filename, comments or free
  852.              space.  The free space choice is an invalid choice if a
  853.              list of volumes is not being displayed.
  854.  
  855.             <N>ext will find the next entry matching the search
  856.              criterion you provided for the <F>ind command.
  857.  
  858.  
  859.         SORT:  <S>ort  on Command Menu
  860.  
  861.             <S>ort can be selected only from Command Menu while PmCat+ is
  862.              running.  However, turning autoSort ON while setting default
  863.              filenames and paths will cause a sort by filename when you
  864.              move from Main MENU to Command Menu to occur automatically.
  865.  
  866.             After selecting <S>ort from Command Menu, you will be prompted to
  867.              choose among filename, ext, size, date and path as the
  868.              options on which to sort.  Select one..
  869.  
  870.             Then you will be prompted for sort order - ascending or
  871.              descending.  Descending puts the largest value first which
  872.              would be appropriate for volume free space (that's the Size
  873.              of volumes) but not for alphabetically arranged data.
  874.  
  875.         CHANGE CATALOGS: <R>ead   on Main MENU
  876.  
  877.             This procedure is identical to the initial reading of a
  878.              catalog when you enter PmCat.  It first clears the memory
  879.              of the existing catalog and then prompts you for a new
  880.              catalog name which you may enter using the keyboard or pick
  881.              list function.
  882.  
  883.  
  884.         MASKS: <M>ask-set on Mask Settings Menu (arrow keys disabled in menu)
  885.  
  886.             The Mask function consists of two portions, Include and
  887.              Exclude and act as a filter.  It works on those files you
  888.              wish to View, Print or Catalog using PmCat+ when either of
  889.              its actions are turned ON.
  890.  
  891.             Include and Exclude may be toggled ON or OFF independently
  892.              of each other by selecting them from Mask Setting MENU.
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.                                                                 Page 15
  907.  
  908.  
  909.             If both are selected, Include takes precedence.  Remember,
  910.              if you turn both ON, NOTHING will be INCLUDED, except what
  911.              you specify and the same goes for EXCLUDE.  This can be
  912.              tricky until you get used to it.
  913.  
  914.             The menu (Mask Settings) for changing the MASK functions is
  915.             accessed thru the <S>et defaults option of Main Menu.
  916.  
  917.             At Mask Settings MENU:
  918.                 Exclude - toggles the exclude list ON/OFF
  919.                 Include - toggles the include list ON/OFF
  920.                 Clear - clears the item pointed to by the bar cursor
  921.                 <ENTER> - allows you to input a new or change the old item.
  922.  
  923.  
  924.     PRINTING: <P>rint on Print Defaults, <P>rint on Command Menu,
  925.     <D>isk from print
  926.  
  927.         FORMATTING OUTPUT:   (arrow keys disabled in menu)
  928.  
  929.             <P>rint selected from Printer Defaults opens a window to allow
  930.             the specification of format parameters for your printed catalog.
  931.  
  932.                 Start-col is the column of the printed page on which the
  933.                  field will begin.
  934.  
  935.                 Width is how many characters the field will occupy on
  936.                  the printed document.  This can be any width you wish,
  937.                  but if it is less than required for any field except
  938.                  comments, it will be truncated (chopped off).
  939.  
  940.                 Comments will print col the width you specify and repeat
  941.                  until on the next line until all actual comments for
  942.                  that file are printed.  Then it will begin printing the
  943.                  next entry.  Comments are left justified.
  944.  
  945.                 Filename is a 12 character field consisting of the
  946.                  filename, a period and the file extension.  It is right
  947.                  justified.
  948.  
  949.                 Size is a number that will occupy 10 spaces.  It is right
  950.                  justified.
  951.  
  952.                 Date will occupy 10 spaces, MM/DD/YY format.
  953.  
  954.                 Path can be up to 65 characters and is the path to the
  955.                  file on its particular volume.
  956.  
  957.                 Volume is the volume name from which the file was read.
  958.                  It may be up to 11 characters and is left justified.
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                                                                 Page 16
  974.  
  975.  
  976.  
  977.         PRINTING:  <P>rint  on Command Menu
  978.  
  979.             PRINTER SET UP STRING: <*>  on Print window menu
  980.  
  981.                 <*> - will prompt you for a new string of characters
  982.                  which will be sent to your printer before printing of
  983.                  the catalog starts.  Each character must be in decimal
  984.                  form and preceded by a '#' and followed by a space.
  985.  
  986.                         e.g.,   #27 #15
  987.  
  988.                  Up to 20 characters may be used here.
  989.  
  990.             ASCII DISK FILE: <D>   on Print window menu
  991.  
  992.                 <D> - will cause the output which would normally go to
  993.                  your printer, to be sent to the disk as a file with the
  994.                  name you specify in ASCII format.  It can be easily
  995.                  edited and/or printed at a later time.
  996.  
  997.     MISC FUNCTIONS:
  998.  
  999.         DELETE VOLUME:
  1000.  
  1001.             <D> - chosen at Main Meny will open a window with all the
  1002.              volumes in your current catalog.  To delete a volume, use
  1003.              the UP/DN arrow keys and select it with the bar and press
  1004.              <ENTER>.  You will still be given an opportunity to abort
  1005.              the operation at this point by answering Y/N on the menu.
  1006.              Obviously this operation is not final till you save the
  1007.              modified catalog to disk...but at that point, it is
  1008.              permanent.
  1009.  
  1010.         ERASE FILE:
  1011.  
  1012.             <K>ill a file from Command Menu.  It is the same process as
  1013.              deleting a volume from Main MENU.  The difference in the two
  1014.              operations is, when you Erase a file, the slot it occupied
  1015.              on the screen is shown >>DELETED<< instead of removed
  1016.              altogether.  As with volume deletion, the operation is not
  1017.              final until you save the modified catalog to disk.
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.                                                                 Page 17
  1040.  
  1041.  
  1042.         COMMENTING FILE:
  1043.  
  1044.             <C>omments may be added to files *and* volumes.  To comment
  1045.              a volume you just select the <V>olume list from Command Menu
  1046.              and select <C> from the menu.  A small editor aids you in the
  1047.              input of your comments.  A 40x2 window accepts your
  1048.              comments.  The UP/DN arrow keys will move between the lines,
  1049.              the HOME/END keys are active and INSERT is the standard
  1050.              mode (there is NO overstrike mode).  DELETE works as well.
  1051.              PgUp/PgDn will accept your comments and immediately place
  1052.              you in the comments field of the preceding or succeeding
  1053.              file, ready to type more comments.
  1054.  
  1055.         OPERATING SYSTEM (Shell):
  1056.  
  1057.             <O> - from Command Menu will execute a call to create a temporary
  1058.              shell in DOS so you can copy, delete, inspect and otherwise
  1059.              wreak havoc on your poor unsuspecting system.  If enough
  1060.              memory is not available, this feature will refuse to work.
  1061.  
  1062.         CHANGING VOLUME LABEL:
  1063.  
  1064.             <#> - chosen when in the <U>pdate section, will read the
  1065.              present disk label, tell you what it is and ask you if you
  1066.              wish to change it.  You MUST have a drive selected for this
  1067.              feature to function.
  1068.  
  1069.         USING THE .DEF FILE:
  1070.  
  1071.             This option, frankly can be tricky if you want a different name
  1072.              than PMCAT.DEF.  PmCat+ will *always* look for 'PMCAT.DEF'
  1073.              when it is run, if it isn't found the internal defaults are
  1074.              used.  The option of providing the alternative .DEF files was
  1075.              to cover the possibility that someone might want an
  1076.              alternative color set or other defaults on occasion.
  1077.              Frankly, I use PMCAT every day and never use this option, but
  1078.              it was an option that was so simple to offer and doesn't get
  1079.              in the way of anything else, that it was put in.
  1080.  
  1081.         USING DISK NUMBERING
  1082.  
  1083.             There are three aspects to using the disk numbering feature of
  1084.              PmCat PLUS.  First, what number to assign the disk and second,
  1085.              how to assign that number.  Finally, you decide whether to
  1086.              allow duplicate disk numbers or not.
  1087.  
  1088.             Also, the disk numbering feature is separate from the
  1089.              sequential numbering of the Volume Labels from within PmCat
  1090.              PLUS.  These numbers are part of the catalog record but are
  1091.              NOT written to the disk.
  1092.  
  1093.             When you catalog a disk with disk numbering active and have
  1094.              decided NOT to allow duplicates, PmCat PLUS will check for
  1095.              the existence of both that disk number and the volume label
  1096.              with which it is associated and issue a warning when it finds
  1097.              duplication of either.
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                                                 Page 18
  1106.  
  1107.             How To Number:
  1108.  
  1109.                 OFF - means ignore the function. A number of '0' is
  1110.                       assigned in this case.
  1111.  
  1112.                 MAN - manual entry of the number.  You do this by simply
  1113.                       beginning to type the number desired for the disk
  1114.                       immediately prior to cataloging that disk.  When
  1115.                       you make the first keystroke, a small text line
  1116.                       will appear on the screen one line above the menu.
  1117.                       If you wish to abort the process, just press <ESC>
  1118.                       and the old number will be left unchanged.
  1119.                       Remember, in this mode you MUST ENTER THE NUMBER
  1120.                       for it to be assigned.
  1121.  
  1122.                 AUT - in this mode, each time a disk is read, the number
  1123.                       that will be assigned to the next disk is
  1124.                       generated auto- matically by incrementing the
  1125.                       prior disk number by one. This feature may be
  1126.                       overridden by manual entry of the number as
  1127.                       described above, for any disk.  Upon entry to
  1128.                       PmCat PLUS, the number is set to zero, unless it
  1129.                       has been saved in the DEF file.
  1130.  
  1131.         USING CATEGORIES
  1132.  
  1133.             A category may be assigned at the same time the disk number
  1134.              above is assigned, though neither is dependent on the use
  1135.              of the other.
  1136.  
  1137.             The category list is accessed by choosing either <C>ategory
  1138.              from the Update window menu or <E>dit from the View window
  1139.              menu.
  1140.  
  1141.             In either case, to set a category for the item of interest,
  1142.              just place the cursor bar on the category you wish and
  1143.              press <ENTER>.  The list of CATEGORIES will automatically
  1144.              be sorted.  They will be saved to your .DEF file when you
  1145.              exit PmCat PLUS.
  1146.  
  1147.             If you wish to have different categories than those in the
  1148.              defaults, just select <U>pdate from the menu while viewing
  1149.              the category window and type in the new category.  A
  1150.              category name is limited to 10 characters.
  1151.  
  1152.             When a category is assigned to a volume before it is read,
  1153.              all files on that volume are assigned the same category by
  1154.              default.
  1155.  
  1156.             The category of any file or volume may be changed by
  1157.              choosing the <E>dit function in the View window menu.
  1158.  
  1159.             In order to limit your viewing or printing of files based on
  1160.              their category, just place the cursor on a file that has
  1161.              the category you want and select <L>imit from the View
  1162.              window menu.
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.                                                                 Page 19
  1172.  
  1173.  
  1174.  
  1175.         USING WILDCARDS:
  1176.  
  1177.             PmCat+'s wildcards are a bit more flexible than DOS's. E.g.,
  1178.              if you type *ca*.* with DOS's dir command, it will show ALL
  1179.              files.  It sees the first '*' and then looks for the '.'
  1180.              and extension wildcard.  If you used that same wildcard in
  1181.              PmCat+ it would find all files with 'ca' anywhere in their
  1182.              filename (not extension).
  1183.  
  1184.             When searching for a string in Comments, don't forget to
  1185.              precede it with a '*' unless you are certain the first
  1186.              character of the comments you want will match the first
  1187.              character of the string you search for.
  1188.  
  1189.             Where '*' assumes ALL characters match, '?' assumes the
  1190.              match of only a SINGLE character.
  1191.  
  1192.  
  1193.         SOUNDEX SEARCHES:
  1194.  
  1195.             When you chose the <F>ind option from Command Menu, you will see
  1196.              four options; filename, comments, size and soundex.  The
  1197.              soundex search functions only on filenames and from the
  1198.              first character.  With those limitations in mind, you can
  1199.              type in a key that simply 'sounds' like the one you want,
  1200.              and PmCat PLUS will locate that file for you.
  1201.  
  1202.             To find a string of characters within a string you must
  1203.              use the wildcards as described above.
  1204.  
  1205.             Soundex searches work in a very unique manner.  The first
  1206.              character (alphabetic) and a numeric code for the rest of
  1207.              the search string, which is generated by the Soundex routines
  1208.              based upon phonetic approximations, are combined into the
  1209.              patter which is searched for.  You will find it matches
  1210.              things you don't expect and doesn't on some things you
  1211.              expect.  A bit of experience in using it can make it a
  1212.              useful tool, however.
  1213.  
  1214.             Basically, type in the word you wish to find, or the closest
  1215.              spelling you can imagine.  The Soundex search may well
  1216.              surprise you with its effectiveness.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.                                                                 Page 20
  1238.  
  1239.  
  1240.  
  1241.         PmCat PLUS and Melange BBS :
  1242.  
  1243.               Support and access is given to registered users on the
  1244.            Melange BBS ( Mr. Scott is changing the name at this time to
  1245.            a different name ) the number will remain the same for a bit.
  1246.            
  1247.  
  1248.             Once a registered user calls, he/she will be given access to
  1249.              the registered user conference and have access to the
  1250.              latest version of PmCat PLUS (registered).  So, if you plan
  1251.              to get the updates, it would be good planning to call and
  1252.              just leave a quick note to let me know you want to be given
  1253.              access.  I'll do so for you as quickly as possible.
  1254.  
  1255.             Even on your first call, you have unlimited download
  1256.              privileges, so don't hesitate to give a ring.
  1257.  
  1258.             All the files may not be commented, but PCBoard allows the
  1259.              user to look into and read files within archives...even
  1260.              download the docs of a program without getting the whole
  1261.              thing! ... and you *can* browse the contents of any
  1262.              archived file while on line.
  1263.  
  1264.             Registered PmCat users will have other benefits on the
  1265.              Melange BBS.  Unregistered users are more than welcome, but
  1266.              will come under 'normal' restrictions.
  1267.